Working With Image or Sequence Settings
The standard dialog component provides two functions that allow you to work with the current compression settings for an image or a sequence of images. You can establish these settings in a number of ways: see
"Setting Default Parameters"
for more information about your options.
You use the
SCGetInfo
function to retrieve settings information. The
SCSetInfo
function enables you to modify the settings.
These functions can work with a number of different types of settings information. When you call either function, you specify the type of data you want to work with. Each of these request types requires different parameter data. See
"Request Types,"
for a description of each of these request types and their data requirements.
SCGetInfo
The
SCGetInfo
function allows you to retrieve configuration information from the standard dialog component.
pascal ComponentResult SCGetInfo (ComponentInstance ci,
OSType infoType, void *info);
-
ci
-
Identifies your application's connection to a standard image-compression dialog component.
-
infoType
-
Specifies the type of information you want to retrieve. The following values are valid:
-
scSpatialSettingsType
-
The component returns its spatial compression parameters.
-
scTemporalSettingsType
-
The component returns its temporal compression parameters.
-
scDataRateSettingsType
-
The component returns information about its compression data rate.
-
scColorTableType
-
The component returns its color table.
-
scProgressProcType
-
The component returns a pointer to its progress function.
-
scExtendedProcsType
-
The component returns information about how you have extended the standard dialog box.
-
scPreferenceFlagsType
-
The component returns its current preference flags settings.
-
scSettingsStateType
-
The component returns its complete configuration.
-
scSequenceIDType
-
The component returns its current image-compression sequence identifier.
-
scWindowPositionType
-
The component returns information about where the standard dialog is positioned.
-
scCodecFlagsType
-
The component returns its current image-compression control flags.
-
info
-
Contains a pointer to a field that is to receive the information.
DESCRIPTION
You use the
infoType
parameter to specify the type of information you want to retrieve. The
info
parameter contains a pointer to a location to receive the information (see this section's introductory text for information about the format of the data that is returned for each request type). If the component cannot satisfy your request, it returns a result code of
scTypeNotFoundErr
.
RESULT CODE
|
scTypeNotFoundErr
|
-8971
|
Component does not have the information you want
|
SCSetInfo
The
SCSetInfo
function allows you to modify the standard dialog component's configuration information.
pascal ComponentResult SCSetInfo (ComponentInstance ci,
OSType infoType, void *info);
-
ci
-
Identifies your application's connection to a standard image-compression dialog component.
-
infoType
-
Specifies the type of information you want to modify. The following values are valid:
-
scSpatialSettingsType
-
Modifies the component's spatial compression parameters.
-
scTemporalSettingsType
-
Modifies the component's temporal compression parameters.
-
scDataRateSettingsType
-
Modifies the component's compression data rate.
-
scColorTableType
-
Modifies the component's color table.
-
scProgressProcType
-
Modifies the component's progress function.
-
scExtendedProcsType
-
Allows you to extend the standard dialog box.
-
scPreferenceFlagsType
-
Modifies the component's preference flags settings.
-
scSettingsStateType
-
Configures the component, based on a saved configuration.
-
scWindowPositionType
-
Positions the standard dialog box.
-
scCodecFlagsType
-
Modifies the component's image-compression control flags.
-
info
-
Contains a pointer to a field that contains the new configuration information.
DESCRIPTION
You use the
infoType
parameter to specify the type of information you want to modify. The
info
parameter contains a pointer to a location that contains the new information (see
"Request Types,"
for information about the format of the data you must supply for each request type). If the component cannot satisfy your request, it returns a result code of
scTypeNotFoundErr
.
RESULT CODE
|
scTypeNotFoundErr
|
-8971
|
Component does not have the information you want
|
© 1997 Apple Computer, Inc.Previous | Chapter Top | Chapter Contents | Next
